================================================================================
============================

			GeneralTouch AcousticWave Touchscreen serial interface
                      README file for touchscreen software for XFree86[tm]&Xorg[tm]


			        	Version 3.1beta
			  Copyright 2001-2006 General Touch Co. Ltd.

================================================================================
============================

Thank you for choosing our RS232,AcousticWave Touchscreen products!! This README
 file contains
additional notes about our touchscreen software which,we think,will help you
 make better use of
our touchscreen and touchscreen software.

Author: Roy.Yin<yhch@generaltouch.com>.2006

NOTE: The Quick start method uses pre-built files.The calibration tool and
 driver were built and tested on a Linux 2.6.11 kernel and Xorg 6.8. They
 have downward compatibility.

===========
CONTENTS
===========
1.QuickStart Guide for touch screen driver and calibration utility
2.Valid entries for each of the lines in the subsection
3.Software Component
4.Problem solution

==================================================================
1.QuickStart Guide for touch screen driver and calibration utility
==================================================================

1) The controller needs to be attached to a serial port and you need to know
 that serial ports name.

2)Install the files
   Login as root ,run setup with "./setup_s" 

3) Calibrate your touchscreen
   run calibrate tool with "./calibrate_u"

4)Install manually
   If there is a problem during installing with setup utility,you can install manually:
   I.Open a terminal,enter the folder of setup_serial,and run"chmod +x uninstall_s;./uninstall_s" first!
   II.The device interface
      If your serial port is COM1,and the device is:/dev/ttyS0
                                  /dev/ttyS1 for COM2 
                                  /dev/ttyS2 for COM3.....
  III.The driver "gentouch_drv.o" 
      Open a terminal,enter the folder of setup_serial,
     A: If the folder "/usr/lib/xorg/modules/input/" is existed,run "cp gentouch_drv.o /usr/lib/xorg/modules/input/"
     B:If the folder "/usr/lib/xorg/modules/input/" is not existed, the folder "/usr/X11R6/lib/modules/input/" is existed,run "cp gentouch_drv.o /usr/X11R6/lib/modules/input/"      
  IV.modify the configure file of XFree/Xorg
      Open your configure file:
      For example:In Redhat 9,the configure file is "/etc/X11/XF86Config"
                         In  Fedora Core,the configure file is "/etc/X11/xorg.conf"
      Find the section "ServerLayout" add the following  line to this section:
	For example :
       Section "ServerLayout"
			Identifier     "Default Layout"
			Screen      0  "Screen0" 0 0
			InputDevice    "Mouse0" "CorePointer"
			InputDevice    "Keyboard0" "CoreKeyboard"
			Inputdevice    "touchscreen_serial" "SendCoreEvents"
		EndSection
     Create a new section at the tail of the configure file,and replace the device interface("/dev/ttySX") with what your get at step II:
     For example :
     Section "Inputdevice"
		Identifier "touchscreen_serial"
		Driver "gentouch"
		Option "Device" "/dev/ttySX"
	EndSection
  V:Restart your X window with "Ctl+Alt+Backspace"
  VI.calibrate
    Open a terminal,enter the folder of setup_serial,
	change the mode of these files:
    "chmod +x genctl gsxcal reporter"
     calibrate:
     "./genctl off;./gsxcal /dev/ttySX ;./genctl  on;"
  VII:uninstall manually
       Delete the contents that come from III to VI
  VII:If the touchscreen does not  work still,run "./reporter",and send the file "/tmp/reporter.tgz" to us

2.Software Component
=======================
Our Touchscreen Software package is composed of the following programs:

          gentouch_drv.o             Our Touchscreen driver for XFree86.

          calibrate_s                Our touchscreen calibration program.

	  genpanel_s		     Our control panel 

	  readme.txt                 It's me!


=====================
3.Problem solution
=====================
1)Permission denied:
  Login to the system console as root and do it again.
2)Can't exit to a text console:
  If your system is running in graphics mode,you must exit to a text console
 prompt first.If your system is set up to automatically start the X window
 system at boot time an provide a praphical login screen,you will need to shut
 down the window system display manager.On many Linux systems,this can be
 accomplished by running the command: 
   #init 3
   If this does not work,you will need to locate and kill the display manager
 process,which is usually one of:xdm,gdm,kdm,or prefdm.
3)To verify that the touchmonitor is connected correctly to the PC and that it
 is functioning correctly, type the following command in an X terminal window: 

   od -h -w10 </dev/ttyS0 # for COM1
   od -h -w10 </dev/ttyS1 # for COM2 

Touch the screen and you should see a group of numbers scrolling down the
 screen. 
4)Not the above
You can just run reporter and email the reporter.tgz which gathered by reporter to us,then we can
 find the problem for you.
NOTES:
   With any notion,advice,demands,
   Contact us.

================================================================================
==============================

                                   General Touch Co. Ltd.
				
  				 http://www.GeneralTouch.com

                                   All rights reserved.

================================================================================
==============================
      

